Graphical Java Lesson 1-6: Taking Control of the Keyboard Action 


This lesson will be dedicated to fixing a small imperfection in the Walking Mario project. When 
you run Walking Mario and move, by holding down the left and right arrow keys, there is a slight 
hesitation between the time you press the key, and the time that Mario continues to walk, after he starts 
walking in that direction. 


That hesitation is caused by the nature of the keyboard's repeat mechanism. Your keyboard has two 
settings that are relevant here: its rate and its delay. When you press a key, the keyboard sends that 
key's virtual key code to the computer. If you hold down that key, it will send that code a second time, 
after a delay (usually between a quarter-second and one full second). That delay causes the hesitation. 
If you continue to hold down that key, the keyboard will keep sending that code, at a rate of some 
number of times per second (usually 2-32), until you let go of that key. 


How can we get rid of the delay, and therefore, the hesitation? On most computers, changing your 
keyboard settings won't help: you can't get rid of the delay entirely. Even if you change your computer's 
keyboard settings, other people's computers will have different keyboard settings, which will cause 
Mario to move a bit differently, on their computers. We need to change our program, so that Mario's 
movement is synchronized with our timer (though still controlled by the keyboard), rather than 
dependent on the rate and delay of the user's keyboard. 


Let's create a new class: Controller. An object of this type will act like a "virtual controller" for our 
game. When the user presses and releases certain keys, this controller's "virtual buttons" will be 
activated or deactivated. After you have created the Controller class, go to your 
Controller.java source file. Our virtual controller is going to have two virtual buttons: "left" and 
"right", so add the following member variables to your Controller class: 


private boolean left; 
private boolean right; 


A virtual button, like a keyboard key, will be in one of two states: "down" or "not down" (up). The 
states of the virtual buttons will be controlled by the keyboard, but their current states will be 
CHECKED every time our timer fires a timer event (50 times per second). When they get checked, 
Mario will move and animate (or not) in response. Therefore, Mario's movement and animation will 
always run at 50 FPS, regardless of the user's keyboard settings. This will give us consistent 
performance on all computers. In addition, if you want to give this program to other people, you won't 
have to tell them to mess around with their computers' settings. 


Add the following constructor to your Controller class: 


public Controller () 


{ 
left = false; 
right = false; 
} 


left will hold the state of the virtual left button, which will be controlled by the left arrow key. If the 
left arrow key is down, then the left button will be down, and left will be true. If the left arrow key 
is not down, then the left button will not be down, and left will be false. Likewise, right will 
hold the state of the virtual right button, which will be controlled by the right arrow key. If the right 
arrow key is down, then the right button will be down, and right will be true. If the right arrow key 
is not down, then the right button will not be down, and right will be false. 


Now, add the following method: 


public void pressLeft () 
{ 

left = true; 

right = false; 
} 


We're going to call this method, rather than mario's moveLeft method, whenever the user presses 
the left arrow key. If the user holds down the left arrow key, our program will keep calling 
pressLeft, but that won't matter. We'll make sure that the virtual left button is down, AND that the 
virtual right button is not down. Since Mario cannot move both left and right, at the same time, we 
want to make sure that Left and right cannot both be t rue, at the same time. They can both be 
false, or either one can be true, but both cannot be true, at the same time. We'll add another 
method, to keep pressLeft company: 


public void releaseLeft () 
{ 

left = false; 
} 


We'll call this method, instead of mario's standStill method, whenever the user lets go of the left 
arrow key. Finally, we'll need a method that will allow us to check whether the virtual left button is 
down or not: 


public boolean isLeftButtonDown () 
{ 


return left; 


} 


This is just an accessor method. Now, let's write the companion methods for the virtual right button, 
which will be controlled by the right arrow key: 


public void pressRight () 
{ 

right = true; 

left = false; 


public void releaseRight () 


{ 
right = false; 
} 


public boolean isRightButtonDown () 
{ 


return right; 


} 


These methods will work just like the ones for the virtual left button. Finally, we'll add one more 
method to this class: 


public void releaseAll1 () 
{ 

left = false; 

right = false; 
} 


We'll call this method, whenever we pause our program. The user won't be able to move Mario, while 
the program is paused, because he will be "locked out of" the virtual left and right buttons. The user 
won't be able to use the left and right buttons again, until he unpauses the program. 


We now have a nice, little Controller class, but it won't be of any use, until we set up a 
Controller object, and make use of it, elsewhere in our code. Go to your WalkingMario.java 
source file. Add the following declaration to your list of global variables: 


public Static Controller ctrl; 
In your main method, right after ... 
paused = false; 

... Insert the following line of code: 

ctrl = new Controller(); 


That will set up our Controller object. Now, go to your KBInput Processor. java source file. 
We're going to refactor a lot of code here, starting in the ke yPressed method. In the 
if (key code == KeyEvent.VK_LEFT) block of the if statement, replace ... 


WalkingMario.mario.moveLeft(); 
WalkingMario.main window. repaint (); 


... With: 


if (!WalkingMario.paused) 
WalkingMario.ctrl.pressLeft(); 


Right now, we're going to temporarily unhook our keyboard input processing code from mario. We're 
going to make it interact with ctrl, our Controller object, since pressing and letting go of the 
arrow keys will affect the states of its virtual buttons, rather than affecting Mario directly. Here, when 
the left arrow key is pressed, if the program is not paused, the virtual left button will be pressed. The 
state of that button will be checked later. We won't repaint the screen here, because we won't need to 
any more. When virtual buttons get pressed, nothing on the screen will need to be updated. Thus, we 
won't need to call the repaint method. Similarly, in the 

else if (key code == KeyEvent.VK_RIGHT) block of the if statement, replace ... 


WalkingMario.mario.moveRight (); 
WalkingMario.main window. repaint (); 


... With: 


if (!WalkingMario.paused) 
WalkingMario.ctrl.pressRight (); 


When the right arrow key is pressed, if the program is not paused, the virtual right button will be 
pressed. The state of that button will be checked later, too. Again, we won't need to repaint the screen 
here, because nothing on it will have been updated yet. 


The P key, which we use to pause and unpause the program, is different. It will not control the state of a 
virtual button, but will still be used directly, to pause and unpause the program. Therefore, the changes 
to the code inthe else if (key code == KeyEvent.VK_P) block will not be as radical. All 
we're going to do is release all of the controller's virtual buttons, whenever the program gets paused. In 
the else block of the if statement nested inside of this block (the only else block in this method, by 
the way), add the following line of code: 


WalkingMario.ctrl.releaseAll(); 


The code in that e1se block should now look like: 


WalkingMario.paused = true; 
WalkingMario.timer.stop(); 
WalkingMario.ctrl.releaseAll(); 


Before we continue, check that the body of your keyPressed method looks like: 


int key code = e.getKeyCode(); 


if (key code == KeyEvent.VK_ LEFT) 
{ 
if (!WalkingMario.paused) 
WalkingMario.ctrl.pressLeft(); 


else if (key code == KeyEvent.VK_ RIGHT) 
{ 


if (!WalkingMario.paused) 
WalkingMario.ctrl.pressRight (); 
} 
elge if (key code == Keykvent.VK. P) 
{ 


if (WalkingMario.paused) 


WalkingMario.paused = false; 
WalkingMario.timer.start(); 


WalkingMario.paused = true; 
WalkingMario.timer.stop(); 
WalkingMario.ctrl.releaseAll(); 


WalkingMario.main window. repaint (); 


Now, we'll refactor the code in the keyRe leased method. Replace the if statement, in that method, 
with the following if statement: 


if (key code == KeyEvent.VK_LEFT) 
WalkingMario.ctrl.releaseLeft(); 

else if (key code == KeyEvent.VK_ RIGHT) 
WalkingMario.ctrl.releaseRight (); 


We've just unhooked this code from mario, and connected it to ct r1. Here, when the user lets go of 
the left arrow key, the virtual left button will be released. This will take place, regardless of whether the 
program is paused or not. However, when the program is paused, it will have no effect. Similarly, when 
the user lets go of the right arrow key, the virtual right button will be released. Again, we won't need to 
repaint the screen here, because releasing virtual buttons will not directly cause anything on the screen 
to be updated. 


We have now unhooked all of our keyboard input processing code from mario. If you run your 
program, Mario will not move or animate AT ALL, when you press the left and right arrow keys! 


We want to get Mario moving again. Mario is only going to move and animate in response to timer 
events, so go to your TimerEventProcessor. java source file. 


In the actionPerformed method of your TimerEventProcessor class, you should see the 
following code: 


WalkingMario.goom.act(); 
WalkingMario.main window. repaint (); 


goom's movement and animation are controlled by our timer. goom only acts in response to timer 
events. Even though the user will still control Mario with the keyboard, we want Mario to act in 
response to timer events. At the beginning of the actionPerformed method, insert the following 
line of code: 


WalkingMario.mario.act(); 


Oh, wait! Our Mario class doesn't have an act method yet! I guess we'd better go make one. Go to 
your Mario. java source file. Let's add the following act method to our Mario class: 


public void act() 
{ 
if (WalkingMario.ctrl.isLeftButtonDown () ) 
moveLeft (); 
else if (WalkingMario.ctrl.isRightButtonDown () ) 
moveRight (); 
else 
standStill(); 


} 


The states of the controller's virtual buttons will be checked here. If the virtual left button is currently 
down, Mario will move left, in response. If the virtual right button is currently down, Mario will move 
right, in response. If neither of the virtual buttons is currently down, Mario will stand still. Thanks to 
the restrictions enforced by the methods of our Controller class, there will NEVER be a time 
when both of the virtual buttons are down, at the same time. If ctr1 ever ended up in that state, 
what would Mario do, in response? 


Finally, run your program. Mario should move left and right, when you press the left and right arrow 
keys. There should be no noticeable hesitation in his movement. He'll also animate very fast, at 50 FPS. 
If you want, you can use the technique described in Lesson 1-4, to slow down his animation. 


